Cloudflare Pages 배포 방식 비교

📅 2026-07-07 10:52 · obsidian-share
2026-07-07 · WF + AI 톡톡 이전 후 검토

세 가지 방식 비교

| | 🟢 GitHub 통합 | 🟡 wrangler 직접 | 🔵 GitHub Actions |

|---|---|---|---|

| 작동 방식 | GitHub push → Cloudflare 자동 빌드·배포 | 터미널에서 wrangler deploy 수동 실행 | GitHub Actions가 wrangler 실행 |

| 설정 난이도 | ⭐ 쉬움 (클릭 5번) | ⭐ 쉬움 (CLI 한 줄) | ⭐⭐ 보통 (yml 작성) |

| 자동화 | ✅ 완전 자동 | ❌ 수동 | ✅ 완전 자동 |

| 빌드 커스터마이징 | ❌ 제한적 | ❌ 없음 | ✅ 자유로움 |

| 빌드 시간 | 30초~1분 | 2~3초 (로컬 업로드) | 1~2분 |

| 의존성 | Cloudflare 서버만 | API 토큰 필요 | GitHub + Cloudflare |

| 무료 한도 | 월 500회 빌드 | 무제한 업로드 | GitHub Actions 2,000분/월 |

1. 🟢 GitHub 통합 (추천)

Cloudflare 대시보드에서 GitHub 저장소를 연결. push할 때마다 자동 배포.

장점

  • 한 번 설정하면 끝. push = 배포
  • Cloudflare 대시보드에서 배포 로그·미리보기 확인 가능
  • 프리뷰 브랜치(Preview Deployments) 자동 생성

    • 단점

  • 빌드 설정이 단순: npm run build 같은 명령어만 가능
  • 빌드 서버가 Cloudflare 소유 → 커스텀 스크립트 제한적
  • 우리 사이트는 빌드 없이 정적 파일만 서빙 → 사실상 오버스펙

    • 설정 방법 (5분)

    1. Cloudflare Pages → 프로젝트 선택

    2. 설정 → 빌드 및 배포 → Git 저장소 연결

    3. GitHub 저장소 선택 (ddokkang2/ai-creator-bus 등)

    4. 빌드 명령: 비워둠 / 출력 디렉토리: . (루트)

    5. 저장 → 끝

    2. 🟡 wrangler 직접 배포 (현재 방식)

    터미널에서 wrangler pages deploy로 로컬 파일을 직접 업로드.

    장점

  • 가장 빠름 — 빌드 과정 없이 2~3초 만에 업로드
  • 우리 사이트처럼 순수 정적 파일에 최적
  • 월 빌드 500회 제한과 무관 (업로드는 제한 없음)
  • git push 없이도 배포 가능 (테스트/핫픽스 유용)

    • 단점

  • 수동 실행 필수 — 배포 까먹을 수 있음
  • git push + wrangler deploy 두 번 해야 함

    • 현재 사용 명령어

    # WF
cd ~/ai-creator-bus-site && npx wrangler pages deploy . --project-name=ai-creator-bus --branch=main

# AI 톡톡
cd ~/dio-ai-talktalk-site && npx wrangler pages deploy . --project-name=dio-ai-talktalk --branch=main

    3. 🔵 GitHub Actions

    .github/workflows/deploy.yml 파일로 CI/CD 파이프라인 구성.

    장점

  • 완전 자동 + 커스텀 가능 (git push 한 번으로 끝)
  • 빌드 전 검증(린트, 테스트) 추가 가능
  • 특정 브랜치만 배포, 조건부 배포 등 세밀한 제어

    • 단점

  • yml 설정 귀찮음
  • Actions 무료 2,000분/월 → 우리 수준에선 충분하지만 관리 포인트 추가
  • 정적 사이트엔 오버스펙

    • 🎯 결론: wrangler + GitHub 통합 혼합 추천

    | 용도 | 방식 | 이유 |

    |---|---|---|

    | AI 톡톡 (주 3회 발행) | GitHub 통합 | 발행 후 push만 하면 자동화. 빈도 낮아도 확실 |

    | WF (하루 5호 배치) | wrangler 직접 | 여러 호를 한 번에 올릴 때 빠르고 유연 |

    왜 이렇게?

  • AI 톡톡은 주 3회 정기 발행 → "push하고 잊기"가 편함
  • WF는 하루에 여러 호를 몰아서 발행 → wrangler로 빠르게 배치 업로드가 효율적
  • 둘 다 무료 한도 안에서 문제없이 운영 가능

    • 바로 할 수 있는 것

  • AI 톡톡: 대시보드에서 GitHub 통합 켜기 (5분)
  • WF: 현재 wrangler 방식 유지, 필요하면 나중에 GitHub Actions 추가